=============================================================================
Easy Import/Export [NAT]
Version: 1.0.0
Compatibility: OpenCart 3.0.x / ocStore 3.0.x
Author: NAT
Support: info@nat.od.ua
=============================================================================

---------------------------------------------------------
🇷🇺 РУССКИЙ ЯЗЫК
---------------------------------------------------------
УСТАНОВКА:
1. В админ-панели OpenCart перейдите в раздел "Модули / Расширения" -> "Установка расширений". Загрузите архив `easy_import_export_nat_OC_30_1_0.ocmod.zip`.
2. Перейдите в "Модули / Расширения" -> "Модификаторы" и нажмите синюю кнопку "Обновить" (Очистить кэш).
3. Перейдите в "Система" -> "Пользователи" -> "Группы пользователей", выберите вашу группу (Administrator), нажмите "Выделить все" в правах просмотра и изменения, затем сохраните.
4. Перейдите в "Модули / Расширения" -> "Расширения" -> тип "Модули", найдите "Easy Import/Export [NAT]" и нажмите "Установить", затем "Редактировать".

ОБНОВЛЕНИЕ:
1. Загрузите новый архив через "Установка расширений" поверх старого.
2. Обновите кэш в разделе "Модификаторы".
3. Очистите кэш браузера (Ctrl+F5) на странице настроек модуля.

УДАЛЕНИЕ:
1. Перейдите в "Модули / Расширения", найдите модуль и нажмите красную кнопку "Деинсталлировать".
2. Перейдите в "Установка расширений", найдите модуль в истории загрузок и удалите его файлы.
3. Обновите кэш модификаторов.

КЛЮЧЕВЫЕ ФУНКЦИИ И ВОЗМОЖНОСТИ:
* Интерактивное превью: При загрузке файла или получении по ссылке модуль моментально выводит таблицу с первыми 5 строками. Это позволяет визуально проверить структуру данных и соответствие колонок перед запуском импорта.
* Умное автосопоставление: Автоматическая привязка колонок прайс-листа к полям OpenCart (Модель, SKU, Цена, Количество, Статус) по встроенным словарям синонимов, защищенная от дублирования связей.
* Живые счетчики импорта: Панель импорта в реальном времени отображает ход работы (Всего строк, Обновлено товаров, Не найдено в каталоге, Пропущено).
* Условные модификаторы цен и остатков: Тонкая настройка правил (например, "Если цена меньше 100 — умножить остаток на 2") с WAF-совместимыми кодами сравнения (eq, ne, gt, lt), которые не блокируются серверами хостинга.
* Парсер ссылок Google Sheets: Автоматическое определение ссылок совместного доступа Google Таблиц и их конвертация в прямую WAF-безопасную ссылку на CSV экспорт.
* Интеграция с REST API поставщиков [BETA]: Встроенный гибкий клиент, поддерживающий GET/POST запросы, авторизацию Basic/Bearer/Custom POST Token, постраничную пагинацию или пагинацию со смещением, а также потоковую memory-safe запись JSON/XML ответов на диск.

КАК РАБОТАТЬ С МОДУЛЕМ:
1. Вкладка "Настройки": Управление лицензией, отображение быстрых кнопок действий в каталоге и редакторах, пути для экспорта.
2. Вкладка "Экспорт": Выгрузка данных в CSV, XML, JSON или Excel. Настройка идентификаторов, фильтров категорий/производителей и формул модификации перед скачиванием.
3. Вкладка "Импорт": Загрузка файлов или указание ссылок, настройка соответствия колонок по превью и запуск импорта с живой статистикой.
4. Вкладка "Автоимпорт (CRON)": Создание множественных задач для автоматического обновления цен и остатков по расписанию с индивидуальными настройками связей и условных модификаторов.


---------------------------------------------------------
🇬🇧 ENGLISH
---------------------------------------------------------
INSTALLATION:
1. Go to OpenCart admin panel: "Extensions" -> "Installer".
2. Upload the `easy_import_export_nat_OC_30_1_0.ocmod.zip` archive.
3. Go to "Extensions" -> "Modifications" and click the blue "Refresh" button.
4. Go to "System" -> "Users" -> "User Groups", edit your group (Top Administrator), click "Select All" for Access and Modify permissions, then Save.
5. Go to "Extensions" -> "Extensions" -> choose "Modules", find "Easy Import/Export [NAT]", click "Install" and then "Edit".

UPDATE:
1. Upload the new zip file via Extension Installer over the old one.
2. Refresh modifications cache.
3. Hard refresh your browser cache (Ctrl+F5) on the module settings page.

UNINSTALLATION:
1. Go to Extensions -> Modules, click the red "Uninstall" button next to the module.
2. Go to the Extension Installer history and delete the module files.
3. Refresh modifications cache.

KEY FEATURES:
* Interactive Pre-upload Preview: Displays a 5-row preview table immediately after file upload or URL fetch to verify data structure and mapping presets.
* Smart Auto-mapping: Auto-detects columns using synonym dictionaries for standard OpenCart fields (Model, SKU, Price, Qty, Status) without mapping collisions.
* Live Import Dashboard: Monitors import runs in real-time, showing count tiles for Total, Updated, Not Found, and Skipped products.
* Conditional Modifiers: Setup robust target-modifier conditions (e.g. "If Price lt 100 -> Qty * 2") using WAF-safe alphanumeric operators (eq, ne, gt, lt).
* Google Sheets Link Converter: Automatically transforms shared Google Sheets URLs into direct CSV export endpoints.
* Supplier REST API Client [BETA]: Built-in flexible client supporting GET/POST requests, Basic/Bearer/Custom POST Token auth, offset/page-based paginations, and memory-safe streaming of JSON/XML payloads.

HOW TO USE:
1. "Settings" Tab: Manage license, paths, and visibility of Fast Import/Export catalog action buttons.
2. "Export" Tab: Dump product data to CSV, XML, JSON, or Excel with custom filters, fields, and pricing modifiers.
3. "Import" Tab: Direct file upload or URL inputs, mapping configurations through visual preview table, and live update stats.
4. "Auto Import (CRON)" Tab: Manage multiple scheduled automation cron tasks, each configured with specific mapping and modifier rules.


---------------------------------------------------------
🇺🇦 УКРАЇНСЬКА МОВА
---------------------------------------------------------
ВСТАНОВЛЕННЯ:
1. В адмін-панелі OpenCart перейдіть до "Модулі / Розширення" -> "Встановлення розширень". Завантажте архів `easy_import_export_nat_OC_30_1_0.ocmod.zip`.
2. Перейдіть до "Модулі / Розширення" -> "Модифікатори" і натисніть синю кнопку "Оновити".
3. Перейдіть до "Система" -> "Користувачі" -> "Групи користувачів", виберіть вашу групу (Administrator), натисніть "Виділити все" у правах перегляду та зміни, збережіть.
4. Перейдіть до "Модулі / Розширення" -> "Розширення" -> тип "Модулі", знайдіть "Easy Import/Export [NAT]", натисніть "Встановити", а потім "Редагувати".

ОНОВЛЕННЯ:
1. Завантажте новий архів через "Встановлення розширень" поверх старого.
2. Оновите кеш у розділі "Модифікатори".
3. Очистіть кеш браузера (Ctrl+F5) на сторінці налаштувань модуля.

ВИДАЛЕННЯ:
1. Перейдіть у "Модулі / Розширення", знайдіть модуль та натисніть червону кнопку "Деінсталювати".
2. Перейдіть у "Встановлення розширень", знайдіть модуль в історії та видаліть його файли.
3. Оновите кеш модифікаторів.

КЛЮЧОВІ ФУНКЦІЇ ТА МОЖЛИВОСТІ:
* Інтерактивне прев'ю: Миттєво виводить перші 5 рядків завантаженого файлу чи посилання для візуальної перевірки відповідності колонок перед стартом імпорту.
* Розумне автозіставлення: Автоматично розпізнає колонки за словниками синонімів для полів OpenCart (Модель, SKU, Ціна, Кількість, Статус) без перехресних конфліктів.
* Живі лічильники імпорту: Панель відображає прогрес виконання у реальному часі (Всього рядків, Оновлено, Не знайдено в каталозі, Пропущено).
* Умовні модифікатори цін і залишків: Гнучкі правила (наприклад, "Якщо ціна менша 100 — помножити кількість на 2") з WAF-безпечними символами порівняння (eq, ne, gt, lt), які не блокуються хостингами.
* Парсер лінків Google Sheets: Розпізнає посилання спільного доступу Google Таблиць та перетворює їх на прямі WAF-безпечні лінки CSV експорту.
* Інтеграція з REST API постачальників [BETA]: Вбудований гнучкий клієнт, що підтримує GET/POST запити, авторизацію Basic/Bearer/Custom POST Token, постраничну пагінацію або пагінацію зі зміщенням, а також потоковий memory-safe запис JSON/XML відповідей на диск.

ЯК ПРАЦЮВАТИ З МОДУЛЕМ:
1. Вкладка "Налаштування": Керування ліцензією, активація швидких кнопок імпорту/експорту в каталозі, налаштування шляхів.
2. Вкладка "Експорт": Вивантаження каталогу в CSV, XML, JSON чи Excel з налаштуванням фільтрів та модифікаторів перед скачуванням.
3. Вкладка "Імпорт": Завантаження прайс-листів, налаштування зв'язків колонок по прев'ю та імпорт з показом статистики в реальному часі.
4. Вкладка "Автоимпорт (CRON)": Створення декількох автоматичних завдань для оновлення за розкладом з індивідуальними налаштуваннями відповідності полів та модифікаторів.